home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / quel / permit.doc < prev    next >
Encoding:
Text File  |  1992-11-19  |  3.2 KB  |  79 lines
  1.  
  2.  
  3.  
  4.  
  5.      PERMIT(QUEL)                 2/7/79                  PERMIT(QUEL)
  6.  
  7.  
  8.  
  9.      NAME
  10.           permit - add permissions to a relation
  11.  
  12.      SYNOPSIS
  13.           _d_e_f_i_n_e _p_e_r_m_i_t oplist { _o_n | _o_f | _t_o } var [ (attlist) ]
  14.                _t_o name [ _a_t term ] [ _f_r_o_m time _t_o time ]
  15.                [ _o_n day _t_o day ] [ _w_h_e_r_e qual ]
  16.  
  17.      DESCRIPTION
  18.           The _p_e_r_m_i_t statement extends the current permissions on  the
  19.           relation specified by _v_a_r.  _O_p_l_i_s_t is a comma separated list
  20.           of possible operations,  which  can  be  _r_e_t_r_i_e_v_e,  _r_e_p_l_a_c_e,
  21.           _d_e_l_e_t_e,  _a_p_p_e_n_d,  or  _a_l_l; _a_l_l is a special case meaning all
  22.           permissions.  _N_a_m_e is the login name of a user or  the  word
  23.           _a_l_l.  _T_e_r_m is a terminal name of the form `tty_x' or the key-
  24.           word _a_l_l; omitting this phrase is equivalent  to  specifying
  25.           _a_l_l.   _T_i_m_es  are  of the form `hh:mm' on a twenty-four hour
  26.           clock which limit the times of the  day  during  which  this
  27.           permission  applies.  _D_a_ys are three-character abbreviations
  28.           for days of the week.  The _q_u_a_l is appended to the  qualifi-
  29.           cation of the query when it is run.
  30.  
  31.           Separate parts of a single _p_e_r_m_i_t  statement  are  conjoined
  32.           (ANDed).   Different _p_e_r_m_i_t statements are disjoined (ORed).
  33.           For example, if you include
  34.  
  35.                   . . . to eric at tty4 . . .
  36.  
  37.           the _p_e_r_m_i_t applies only to eric when logged in on tty4,  but
  38.           if you include two _p_e_r_m_i_t statements
  39.  
  40.                   . . . to eric at all . . .
  41.                   . . . to all at tty4 . . .
  42.  
  43.           then when eric logs in on tty4 he will get the union of  the
  44.           permissions  specified  by the two statements.  If eric logs
  45.           in on ttyd he will get only the permissions specified in the
  46.           first  _p_e_r_m_i_t  statement, and if bob logs in on tty4 he will
  47.           get only the permissions  specified  in  the  second  _p_e_r_m_i_t
  48.           statment.
  49.  
  50.           The _p_e_r_m_i_t statement may only be issued by the owner of  the
  51.           relation.   Although  a  user other than the DBA may issue a
  52.           _p_e_r_m_i_t statement, it is useless because noone else  can  ac-
  53.           cess her relations anyway.
  54.  
  55.           _P_e_r_m_i_t statements do not apply to the owner of a relation or
  56.           to views.
  57.  
  58.           The statements
  59.  
  60.                   define permit all on x to all
  61.                   define permit retrieve of x to all
  62.  
  63.           with no further qualification are handled as  special  cases
  64.           and are thus particularly efficient.
  65.  
  66.      EXAMPLES
  67.             range of e is employee
  68.             define permit retrieve of e (name, sal) to marc
  69.                  at ttyd from 8:00 to 17:00
  70.                  on Mon to Fri
  71.                  where e.mgr = "marc"
  72.  
  73.             range of p is parts
  74.             define permit retrieve of e to all
  75.  
  76.      SEE ALSO
  77.           destroy(quel)
  78.  
  79.